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Preface 


This document is the Programmer Reference Manual for the SPERRY UNIVAC Series 90 Data Base Management 
System (DMS/90). It is one of a series of manuals covering DMS/90. Because this manual contains the schema and 
subschema definition languages, it is a prerequisite to the use of the other reference manuals in the series covering 
DMS/90. For introductory concepts to DMS/90, refer to the data manipulation language manual, UP-8036 (current <« 


version). 
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1. Introduction 


1.1. GENERAL 


This manual describes the schema and subschema data description language (DDL) of the SPERRY UNIVAC Series 
90 Data Base Management System (DMS/90). 


The schema is defined as the total description of a data base, including the names and descriptions of all areas, 
records, and sets. The language used in describing the schema is called the schema DDL. 


The schema DDL compiler generates a description of the data base that is stored in the first 500 pages of the data 
base itself. This data base description, or output schema, consists of records organized in a network data structure. 
In fact, the schema compiler uses the run time data base management system (DBMS) routines of DMS/90 and a 
predefined object subschema to create the output schema. The output schema is later referenced by the subschema 
/ @ DDL compiler, which also stores records in the same network data structure to describe a particular subschema. A 


A subschema is defined as that portion of the total schema (selected areas, records, and sets) which is of interest to 
one or more specific application programs. The language used in describing a subschema is called the subschema 
DDL. 


The subschema DDL compiler generates a description of a portion of the data base. This description takes two 
forms. One form is assembler source code that is subsequently assembled and added to an object module library file. 
This form, the object subschema, is later link edited with any COBOL (DML) application programs that invoke the 
subschema. The other form consists of records stored in the same network data structure as the output schema, i.e., 
in the area consisting of the first 500 pages of the data base. This form is subsequently referenced by the DML 
preprocessor when a COBOL (DML) application program that invokes the subschema is processed. 


The maximum number of subschema descriptions that can be stored in these first 500 pages can vary, depending on 
the size of the schema and subschema, and the physical size of each page. 4 


One schema and one or more subschemas may be described for a given data base. The resulting descriptions must be 
logically consistent with one another. 


1.2. SYMBOLS, RULES, AND NOTATIONS USED IN THIS MANUAL Y 


The various lanquage elements that comprise a schema and subschema DDL program must be written in formats that 
adhere to fixed and precise rules of presentation. Each format statement indicates the following information: 


od] s order of presentation; 


) words that are requisite to the proper functioning of the statement; 
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Y a words that are optional and are included at the discretion of the user; 
a information which must be supplied by the user; & 





a elements in the statement that involve a choice by the user; 
A a functions of the statement that are optional. 

in accordance with the foregoing, the following conventions are used in this manual: 

1. The order of presentation is indicated by the format statement itself. 

2. All DDL reserved words appear in all capitals. They are also listed in Appendix A, 

3. Words in all capitals that are underlined are key words. Key words must be present when the functions in 
which they appear are used except in the case of default options (rule 5). Those capitalized words not 
underlined are optional and may be included at the user's discretion to improve readability; there is no 
compiler action. All completely capitalized words, whether underlined or not, are part of the DDL language 
and must be spelled exactly as indicated. 


4. All lowercase words represent generic terms to be supplied by the user when the functions of which they are a 
Part are used. 


5. Elements of a statement involving a choice, one of which must be chosen, are enclosed in braces { }. If one of 
the choices within the braces has no key words, it is a default option; i.e., if none of the elements within the 
braces is specified, the action will be the same as if the default option had been specified. 





6. Optional functions, which may be included or omitted at the user's discretion, are enclosed in brackets []. 
When two or more items are stacked within brackets, one or none of them may be specified. 


7. In some statements, certain portions may be used as many times as needed by the programmer. The ellipsis (. . 
.) indicates this repeatability. If there is a choice to be made from stacked options, or if there is only a single 
possibility, brackets or braces are used as delimiters to indicate that portion of the statement which is 
repeatable. 


8. Periods must be used where shown and must also appear at the end of each paragraph. 
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2. Language Considerations 


2.1. DATA DESCRIPTION LANGUAGE STRUCTURE 
The structure of both the schema and subschema data description language (DDL) has its foundation in the DDL 


character set where one or more characters form a word, one or more words form a clause, one or more clauses form 
a sentence, and one or more sentences form a paragraph. 


2.1.1. DDL Character Set 


The complete DDL character set for the SPERRY UNIVAC Series 90 Data Base Management System (DMS/90) is: 


0,1,...,9 
@ A,B,..Z 
Blank or space (written on coding form as A, or a blank space) 
Period 
< Less than 
( Left parenthesis 
+ Plus sign 
$ Currency sign 
Asterisk 
) Right parenthesis 
; Semicolon 


- Minus sign or hyphen 


é Comma 


@ > Greater than 


Apostrophe (alternate character for quotation mark) 


2-1 
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il 


Equal sign 





mW 


Quotation mark (see apostrophe) 
/ Slash 
The period, comma, semicolon, and space characters may be used for punctuation where the period terminates a 


sentence or paragraph, and the other characters denote separation between words or clauses. The period, comma, 
and semicolon are recognized as punctuation only when followed by the space character. 


2.1.2. DDL Words 

DDL words are composed of 1 to 30 characters from the preceding character set. Allowable combinations of 
characters are dependent on the type of word. A word is terminated by one of the punctuation characters given in 
2.1.1. 

2.1.3. Types of Words 

There are three types of words in the DDL: reserved, schema and subschema nares, and constants. 


o Reserved Words 


Reserved words are used for syntactical purposes and may not be used as user-supplied words. There are two 
types of reserved words: key and optional. 





- Key reserved words are required in a DDL statement. These words are capitalized and underlined in the 
syntactical formats shown in Sections 3 and 4. 


_ Optional reserved words are those which may be used in a DDL statement as desired for syntax clarity 
and are capitalized but not underlined in the syntactical formats. 


Appendix A contains a complete list of reserved words used by DMS/90. 

—_ On Schema and Subschema Symbolic Names 
Schema and subschema names must be constructed from the letters, digits, and hyphen characters only. The 
name must contain at least 1 letter, be no more than 16 characters in length, and not begin or end with a 
hyphen. The hyphen must be preceded and followed by a letter or digit. Exceptions are noted in the text 
where applicable. 


a Constants 


Constants are used to establish initial data values for data items defined by the schema DDL. Constants are 
classified into two categories: literals and figurative constants. 


Literals may further divide into numeric and nonnumeric. 


_ Numeric literals are associated with numeric data items and are not enclosed in quotation marks. 





Nonnumeric literals are associated with nonnumeric data items and are enclosed in quotation marks. @ 
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Figurative constants are reserved words which are equated to specific values and may be associated with 
numeric or nonnumeric data items. The following figurative constants are recognized by the schema DDL 
processor: ZERO, ZEROS, ZEROES, SPACE, SPACES, HIGH-VALUE, HIGH-VALUES, LOW-VALUE, and 
LOW-VALUES. 


2.2. DDL ORGANIZATION 


The organization of the schema and subschema DDL is discussed in detail with the syntax description in Sections 3 
and 4 of this manual. 


2.3. DDL CODING FORM 


Schema and subschema DDL processor input record format is 80 characters equatable to one line of information 
from the standard COBOL coding form. Figure 2—1 shows the layout of the COBOL coding form. On this form, the 
programmer, using the rules of format and content defined in this manual, enters all the information needed by the 
DDL compiler. Table 2—1 explains the divisions of the form. 


Se veAS COBOL n * 
PROGRAMMING FORM prooran 1.0. bi i 
PROGRAM pn nn a PROGRAMMER PATEL PAGEL 








Figure 2-1. COBOL Programming Form 





2-3 
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Table 2—1. Prograrmming Form Column Usage 






















A numeric entry, used only by the programmer (not the DDL 
processor) to establish a sequence among the various lines of 
coding (optional). 







A hyphen (—) is used when an entry extends past one noncomment 
line. A break is used in the middie of a word, and the hyphen 

is written in column 7 of the next contiguous fine on which the 
word is completed. A word may be interrupted in any column, the 
rest of the line space-filled, and completed on the next line. 

If the continued fine contains a nonnumeric literal without s 
closing quotation mark, the first nonblank character in Area B 

of the continuation line must be a quotation mark, and the contin- 
ustion starts with the character immediately after that quotation 
mark. 


7 









An asterisk (*) in column 7 signifies a comment fine which will 
be printed but ignored by the compiler. A comment may sppeer 
anywhere in the program and can contain any printable combination 
of characters including reserved words. If a comment entry 
extending past one line has a break occurring in the middie of 

a word, the continuation line must contain an asterisk in column 

7. (The hyphen is only used for noncomment continustion lines.) 








All ODL-formatted information, in the form of names, statements, 
information, instructions, etc., that is to be compiled into the 
object program. 








Note that two left-margin limits designated “A” and “B” are 
shown. These are needed for program alignment. Major definitive 
names are begun at margin A (column 8). Margin B (coturnn 12) is 


8-72 TEXT 
; : used for subordinate items and for continuations of entries from 
the last preceding line. , 


| 7-80 IDENTIFICATION Card deck information (optional) 
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3.1. GENERAL 


3. Scheha Date DESet Pts Tahguage 


:s9iny 

"z-so8e1ut NUHL L-se8e3u! ¢] SONVH eweu-eale S| SWVN VaHV 
2qeUUOY 

"ease Wein jo abues abed oy ‘aie pue ‘BWaYyos {£301 ap JO wale Ue SayIUEp! soUSIUSS SWYN WAY O4L 
:uonouny 


guess JINVN VWauV “LVS 
The schema data description language (schema DDL) is a subset of the April 1971 CODASYL Data Base Task Group 


language specification, and is used to describe an integrated data base which is destined to reside on disc. 
“peiioeds aq isn soUus.USs SWIVN VS duo jo WNWIUIW YZ 


3.2. ORGANIZATION @iBudtd le SG HEM AyD BM bornue jeuonippy “soeds e pue porsed @ Aq parAoj1o3 


NOILdIHOS3C W3YV SPz0m ain yo pesoduico eweu Yydeibered 2 nim UiBeq UaWalEIs UONdHOSap Bol = *L 
The schema DDL is composed of the following four groups of statements: 


sainy 
1. . Schema description 
“z-seBeut NYHL L-s9603u4 S$} SONVY SweU-eoue S] SINVN VauV 
2. Area description 7 
"NOlidi YOSad V3HV 


3. Record type description 





4. Set type description cary 


Each statement group must appear in the sequence shown, each describes a specific aspect of the total schema, and 
each relies on descriptive statements from the prior group or groups. 

27eULOY 
Each statement group begins with a descriptive paragraph name. Processing of statements for a specific group begins 


with the associated paragraph name and ends either with the recognition of the paragraph nBAE YePAD FP BLE BPoup 
or Re Oe PRA PHL PHAR PHB UR Rua Inle2O3 ay jO Seese B10L JO GUO Ajijuap! sjusUsze7s uonduosep ease 8UL 


In addition to these statement groups, optional processor report contro! and input sequence check control parsers 
statements (3.7) may be entered in the statement input stream prior to the schema description statements. 
SLNAWSLVLS NOLLd IHDSSG VAYV ‘PE 


3.3. SCHEMA DESCRIPTION STATEMENTS eee 
* [SueWUIOS] "SHYVW3Y 


Function: 
:JeULIOg 


Schema description statements identify the schema, and may define the page range of the schema (at the user’s 
option), identify the schema author, define the date of schema creation, seatlty the installatio: RSH the 


WOR UTE aA AARERCA UR HPPA SSH AE LE EIRE BEE Se feHent sia Hee Shig, SHUVWSY eUL 


suogouny 


ydeibeled SIYVWAY ‘SES 


a29vd NOISIAZM 39va By2aGnnnedn 


06 $18S NYVAINN AHHS4S "Ae 2208 
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a 5. The integer-1 word must be an unsigned number composed of one to eight numeric digits, greater than 
<< or equal to 500, representing the lowest page number of the schema (not including page zero). This 


number must be higher than the DMS/90 reseneeshsssen, porbinte irGiediosstbprmayeonpnpisinwd 0 through 
si sabues 462s psoses pue ease yo Burypne s0sseooid Juanbesqns ‘paijyioeds si esneP JONWY 83 HP 


6. The integer-2 word must be an unsigned number composed of one to eight fwenGriaidights#6presenting 
ayy wou shaddahpsbraqennenhes.e biwuscbepsscuaide afeatssiinogmatpasraiupshendeemgeuhyos ay, = “E 


“aut{ ua Ns 10 wes aly JO Paue g atQ UI SUIbeq JONWY PIOM au ‘paijioeds si asneP ONY OUI} = *Z 
3.3.2. AUTHOR Paragraph 


"eee y oyy U! suiBeq YINZHOS P/OM au, =“ 


Function: ‘ 
:samny 
The AUTHOR paragraph is treated as a comment entry and is presented on the processor input statement 
listing. *[z-ueBequt NUL L28aIUI S$} JONYVH) Cweu-eweys $1 SINWN VSHOS 
Format: BUOY 
AUTHOR. [comments] . *ewayos 
ayy jo aGues aBed ayy sauijep ‘uondo S,iesn ay 12 ‘pue eWaYos ay saizQUep! soUaIUes JWYN WW3HOS eUL 
3.3.3. DATE Paragraph :uogoun4 
Function: BOUSUSS aWYN VIWSHOS ‘e|e 


The DATE paragraph may be used to eek a schema date of creation other than the computer date. If the 
f° . date override feature is not desired, the DATE paragraph must be omitted entirely and the computer date is 
f @ assumecPROP Shera tine OY EidotRande Aeu saisjua pazelsosse pue sudesGesed jeuondo Guiluiewas ayy =“ 


Format: ‘WeES INduUI 7QC eWeYSS YQ UILBIM SdUSTLIES at) JO BOUaUNODO AjuO atp aq IsNW pUe 
‘sweu ydesBesed NOLLdINOSAG WNAHOS 242 Mojjoy Ajazeipauiuy! IsnwW soURUEs 3WIYN WWSHOS MUL = “7 
DATE. date-entry. 
"pesouby ave aut; awes ayy u! seique jevonippy ‘eceds e pue ported e Aq pamojjo} NOLLd IHOS3G 
Rul@ANSHOS spsom ayy jo pesoduioo aweu ydeiGeied e yyw ui6eq squewajeys ucIduosep ewaipg ‘1 





2s 
1. The word DATE begins in the A area and must be followed by a period and a space. any 


2. The date-entry word must accompany the DATE paragraph name and begin Ya the Banal SW tbe 


line. The date-entry word must be eight characters in the form mm/d the 
month, day, and year numbers, respectively. f faetttss]" (NOILVTIVISNI] 
. [Ague-svep "31 VG) 
3.3.4. INSTALLATION Paragraph + juounoa) "HOHIAVI 


Function: 


* [z-se6snut NYHA L-20881U! S$] JONWY) aweU-eweUs s] SWYN VWSHOS 


The INSTALLATION paragraph is treated as a comment entry and is presented_on_the processor_input 
statement listing. NOIMid!H9S3d0 VINSHOS 






Format: 


© INSTALLATION. [comments] . 


39Vd NOISIASY 39v¢ MAGWNANe dh 


z-€ 06 $9148 DVAINN AYY3dS L ‘My 7208 
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5. The integer-1 word must be an unsigned number composed of one to eight numeric digits, greater than 
ros. or equal to 500, representing the lowest page number of the schema (not including page zero). This 

© number must be higher than the DMS/90 reseneephaseg, pointe inGedies;tbprmageonpapsitad 0 through 
St sabues $62; pscoes pue eose yo Buiyipne sosseo0id quanbasqns ‘paiyioeds si asneP JONVY 8 HP 


6. The integer-2 word must be an unsigned number composed of one to eight namneudigthtswepresenting 
au woy cheddahebasgeuuenbese ottwuschepescod de afieaissiinngrmeatpisalupsbendnmgeuhyss ou, =f 


4 suenbaeons Jo auies ay} x Raut g aun ur suj6eq JONWY PiOM aut ‘paioeds Ss} asneP FONWH UH |Z 
OR Paragrap 


"eaue y Oy Ul suIBeq YINZHOS PIOM aut *L 


Function: 
:sany 
The AUTHOR paragraph is treated as a comment entry and is | is presented on the processor essor input statement 
listing. [z-seBequt NYHL b428eau! $1 FDNVY] eweu-eweys sj SWVN VWSHOS 
Format: 7BUIO4 
AUTHOR. [comments] . *eWUaYos 
ay jo aGuei abed etn sauljsp ‘uondo S,Jesn ain 12 ‘pue eWayos a2 Sa1;QUSp! soUajUEsS WYN VASHOS 241 
3.3.3. DATE Paragraph : suogoun4 
Function: e0ua}UaS aWVN VISHOS “Lee 


The DATE paragraph may be used to per a schema date of creation other than the computer date. If the 


a , date override feature is not desired, the DATE paragraph must be omitted entirely and the computer date is 
fh & - assumecPrerehternaaaa S¥eiusipende Aeu saisjua peyeloosse pue sydeiGesed jeuondo Guiuewa ayy, =“ 


Format: WEOS INdUI GQ BWIEYSS aU) UILAIM BdUSzUSS at] JO aOUa.LINODO AjUO 3uy aq IsNW pus 
‘aweu ydesesed NOLLdINOSAG WNAHOS 88 Mojjoy Ajayeipawiul isn souRuEs FWYN YWSHOS e4UL = “‘Z 
DATE. date-entry. 
“po.oufs a1e 301; awes ayy Ut SoiQua jeudIpply ‘sceds e pue poised @ Aq pamo}joj NOlLd!dOSs3ad 
RufeSN3HOS sps0om ay2 jo pesodwoo eweu ydeibered e ym uibeq sjuaWwajels UONdUOSep eWweips “L 





: 4 3s 
1. The word DATE begins in the A area and must be followed by a period and a space. ony 


2. The date-entry word must accompany the DATE paragraph name and bbgitt Lik epaiiiaens 


line. The date-entry word must be eight characters in the form mm/d ry,wh the 
month, day, and year numbers, respectively. (fmt SuRto3] “NOILVTTVISNI] 
['Ague-siep “3. 1vGl 


3.3.4. INSTALLATION Paragraph [ fauounuosy “GOATAVI 


Function: 


* pe-seBoquy NYHL L-68e1u! S| JON VY] eueU-eweUps $j SWYN VWSHOS 


ete t e@ and is ne OSn ON 
Pe tare oy Perem en ne rencea ete eormerates, Sel eet eer maeiG GHaies 
statement listing. 







Format: 


€ INSTALLATION. [comments] . 


39V¥a NOISIARY 39Va 


3-3 


Wa GWaANTAN 


z-e 06 $8128S DVAINN AXYadS 4 “AH ZZ08 
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(3. SchMa Date DESEr PSH Tahguage 


sseiny 
*z-se803u! NULL L-se8e2u! $] FONVH eweu-eale S| SVN VaHV 

[JeUU04 
"Bole 284 JO aBue a6ed ayy Son pue ‘eueys [£20] atp JO eae Ue sayiUep! soUsIUES SWWN WAHV OUL 


suonoun 
3.1. GENERAL 


aay : ; eous}Uss JINVN V3SHV Lv’ 
The schema data description tanguage (schema DDL) is a subset of the April 1971 CODASYL Data Base Task Group 


language specification, and is used to describe an integrated data base which is destined to reside on disc. 
“Peijjoods aq Isnus soUaUSS SIN VS 2U0 jo WNUUIW YZ 


3.2. ORGANIZATION) CGS SGHEM AUR bornue jeuorippy “soeds & pue poised & Aq penoi}o; 


NOILdIHDS3C WAU sps0Mm at jo pesodwico eweu ydeibesed @ inim UiGaq SjuaWWazeys UONIdLOSap Bony = “| 
The schema DDL is composed of the following four groups of statements: 


sainy 
1. . Schema description 


“z-s08eRU! NYHL L-2e6eIu S} FONVY eweU-eque Ss] WYN VaHV 
(® 2. Area description -_ 
‘NOlLdI NYDS30 Wav 


3. Record type description 





4. Set type description 


Each statement group must appear in the sequence shown, each describes a specific aspect of the total schema, and 
each relies on descriptive statements from the prior group or groups. 

seuul04 
Each statement group begins with a descriptive paragraph name. Processing of statements for a specific group begins 
with the associated paragraph name and ends either with the recognition of the paragraph nBAYaPAHE aex? Group 
or wety GPRA PL PHAR PBT aa eto} aU] JO seese S10W JO BuO Ajnuap! SjusWws}e1$ uonduosap Base 3} 


in addition to these statement groups, optional processor report contro! and input sequence check control pardtere’s 
statements (3.7) may be entered in the statement input stream prior to the schema description staternents. 
SLNAWSLVLS NOILdIY9S3SO V3auvV “be 


3.3. SCHEMA DESCRIPTION STATEMENTS Seniors 
* [SueUICS) "SHYVWSY 


Function: 
17RUUOY 


Schema description statements identify the schema, and may define the page range of the schema (at he user’s 
option), identify the schema author, define the date of schema creation, identify the installatio PSH! the 


OWLS SOY! ARSERPAN URAL PRHREIRS SLOUP AP UEEARY OA ThE SEASHONT AAA TSANG. SAU VWaY UL 


@ suogouny 
‘ a 


po udesbeied SHYVINSH ‘SEE 


3ovd NOISIARZM 29Vd eSaennnedn 


wo sR sees QYVAINGO AMHaaS "ME ZCOB 
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2. If multiple areas are defined, the associated AREA NAME sentences may be placed in any desired 
sequence. 


3. The area-name word must be a unique name and conform to the rules for formation of schema and 
subschema symbolic names (2.1.3). 


4. Schema pages assigned to one area may not be assigned to any other area. An area may not be partially 
or wholly contained within another area. Schema pages may be left unassigned to any area. 


5. The integer-1 word must be an unsigned number composed of one to eight numeric digits representing 
the lowest page number assigned to the named area. 


6. The integer-2 word must be an unsigned number composed of one to eight numeric digits representing 
the highest page number assigned to the named area. The integer-2 word must be of equal or greater 


value than integer-1. 


7. The integer-1 word and the integer-2 word must be consistent with the range specified in the schema 
name sentence. 


3.5. RECORD DESCRIPTION STATEMENTS 
Function: 


wae? 4 . F : 
Record description statements identify one or more records of the total schema, and define the mode of 
storage, the area of storage, and the data content for each record. 


Format: 





RECORD DESCRIPTION. 


RECORD NAME IS record-name. 
RECORD ID IS integer. 


LOCATION MODE IS 





DIRECT FIRST 
CALC USING identifier DUPLICATES ARE { LAST 2 
VIA set-name SET NOT ALLOWED 


WITHIN area-name AREA. 


level-number 


data-name-1 
FILLER 
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[1s EDEFINES data-name-2] 





DISPLAY 
COMP 
COMPUTATIONAL 
COMP-1 

[USAGE IS] COMPUTATIONAL-1 
COMP-2 
COMPUTATIONAL-2 
COMP-3 
COMPUTATIONAL-3 


SYNCHRONIZED 
sync. 


ae 
er 


1S character-string 
[VALUE IS literal] 
[OCCURS integer TIMES] 


{INDEXED BY index-name] . 


Rules: 


1. Record description statements begin with a paragraph name composed of the words RECORD 
DESCRIPTION followed by a period and a space. Additional entries in the same line are ignored. A 
RECORD NAME sentence must immediately follow the RECORD DESCRIPTION paragraph name, and 
a minimum of one record must be described for a schema. 





2. The description of a schema record is accomplished by entry of one RECORD NAME, RECORD ID, 
LOCATION MODE, and WITHIN sentence, and a minimum of one data-item sentence. The RECORD 
NAME sentence must be the first for each record described, and the data-item sentence or sentences 
must be the last for each record. 


3.5.1. RECORD NAME Sentence 
Function: 

The RECORD NAME sentence alphanumerically identifies, by name, a schema record type. 
Format: 

RECORD NAME IS record-name. 


Rules: 





The word RECORD may begin in the A or B area. 
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2. The record-name word must be a unique name and conform to the rules for formation of 
@ schema/subschema symbolic names (2.1.3). 


3.5.2. RECORD ID Sentence 





Function: 

The RECORD ID sentence numerically identifies, by number, a schema record type. 
Format: 

RECORD ID IS integer. 
Rules: 

1. The word RECORD may begin in the A or B area. 


2. The integer word must be an unsigned number composed of three or four numeric digits from the range 
100 through 9999. Numeric identifiers from 1 through 99 are reserved for use by DMS/90. 


3. The integer word values on subsequent RECORD ID sentences may be assigned arbitrarily. 


3.5.3. LOCATION MODE Sentence 
& Function: 
The LOCATION MODE sentence defines the selection or storage criteria for a record occurrence in an area. 
Format: 


LOCATION MODE IS 


DIRECT 
FIRST 

CALC USING identifier DUPLICATES ARE 4 LAST 2 
NOT ALLOWED 

MIA set-name SET 


Rules: 


1. The word LOCATION may begin in the A or B area. All subsequent clauses and words of the sentence 
must be entered in the B area of the same or following lines. 


2. Only one of the modes DIRECT, CALC, or VIA may be selected for a specific schema record. 


3. DIRECT mode is specified for a schema record which is to be stored into a specific data base area or 
page dependent on user direction through the data manipulation language (DML) preprocessor supplied 
currency-status field DIRECT-DBK. See the DMS/90 data manipulation language programmer reference 
manual, UP-8036 (current version). 








UP-NUMBER PAGE REVISION PAGE 
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4. CALC mode is specified for a schema record which is to be stored into a specific data base page based on 
the randomized contents of an identifier described within the record, and the page range associated with 
| the record. A standard randomizing module, XR7CALC, is provided with DMS/90 and is used by 
default. If the user wishes to provide his own randomizing algorithm, however, he may create his own 
CALC module and link it with all application programs. Details of this process are given in DMS/90 
system support functions, UP-8037 (current version). 





5. The identifier word must be the name of a data item defined by a data-item sentence for the schema 
record. Any group or elementary data item may be used as an identifier with the exception of the 
following: data items named FILLER, data items which redefine or are subordinate to a data item which 
redefines, and data items which are occurred or are subordinate to a data item which is occurred (3.5.5). 

6. A DUPLICATES clause is associated with the CALC mode, and is a required entry. A duplicate record 
will be stored in a first-in, first-out (FIFO) or last-in, first-out (LIFO) sequence or not stored at all 
depending on the clause entry. 


7. VIA mode is specified for a schema record which is to be stored into a data base as a member record ina 
set relationship, and as such should be located as close as possible to owner record of the set. 


8. The set-name word must be the name of a set which is defined within the schema. 


3.5.4. WITHIN Sentence 


Function: 


The WITHIN sentence is used to specify the area of the schema into which a record may be stored. 





Format: 
WITHIN area-name AREA, 
Rules: 


1. The word WITHIN may begin in the A or B area; all other clauses or words for the sentence must begin 
in the B area of the same or subsequent lines. 


2. The area-name word must be the name of an area that is defined within the schema. The page range 
associated with the named area is assigned to the schema record. 


3.5.5. Data-Item Sentence 
Function: 


The data-item sentence defines group or elementary data items of a schema record. 











WN ame TS. F wt bes kit es WINE AA VSI ISS UV 
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Format: 
ane be data-name-1 
jevei-number FI L LER 
{REDEFINES data-name-2] 
DISPLAY 
COMP 
COMPUTATIONAL 
COMP.1 
[USAGE 1S]{ COMPUTATIONAL-1 
COMP-2 
COMPUTATIONAL-2 
COMP.3 
COMPUTATIONAL-3 
SYNCHRONIZED 
SYNC 
PICTURE : 
{ Sa iS charac] 


[VALUE IS literal] 


[OCCURS integer TIMES] 





[INDEXED BY index-name] . 
Rules: 


1. The level-number word may begin in the A or B area; all other clauses or moms! for the sentence must 
begin in the B area of the same or subsequent lines. 


2. The structure of and the rules governing the formation and use of the data-item sentence within the 
schema DDL are similar to those of the data description entries of COBOL. (See COBOL supplementary 
reference manual, UP-7973 (current version).) Exceptions and restrictions to COBOL are noted where 
applicable. 

3.5.5.1. Level Number and Data Name/FILLER 


Function: 


The level number identifies the group or elementary relationship of a data item to the total record and to 
other data items within the record. 


Format: 
data-name-1 
level-number FILLER 
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Rules: 


1. The tevel-number word must be a 2-digit number from the series 02 through 49. Note that special level 
numbers (such as 66, 77, 88) and their associated functions are not recognized by the schema DDL 
Processor. 





2. The data-name-1 word must be a unique name and conform to the rules for formation of schema and 
subschema names (2.1.1). 


3. FILLER may be used to specify elementary or group items that are never referred to directly in the 
Program, and therefore need not be named. These data items that are never referred to in the program 


do occupy space within the record; hence, this space must be defined to ensure proper alignment of data 
items that are used. 


3.5.5.2, REDEFINES Clause 


Function: 


The REDEFINES clause permits the redefinition of storage previously defined in a data-item sentence for the 
record. 


Format: 
REDEFINES data-name-2 


Rules: _ 





1. The level number associated with the redefining data item must be equal to that of the redefined item. 
2. The data-name-2 word must be the name of a previously defined data item. 


3. A data item which redefines or which is subordinate to one which redefines may not be used as a control 
identifier for CALC location mode storage or for a sorted set. In addition, no VALUE clause may be 
specified for the item. 


3.5.5.3. USAGE Clause 


Function: 


. The USAGE clause specifies the manner in which a data item is represented in storage, and may only be 
specified at the elementary level. A usage of DISPLAY is assumed in the absence of the clause. : 


Format: 


DISPLAY 
COMP 
COMPUTATIONAL 
COMP-1 

[USAGE 1S}( COMPUTATIONAL-1 
COMP-2 
COMPUTATIONAL.2 5 
COMP-3 Nad 
COMPUTATIONAL-3 
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Rules: 


1. DISPLAY usage specifies data-item storage in character format (one character = eight bits = one byte). 
At the elemental level, a PICTURE clause must accompany this usage. 


2. COMPUTATIONAL usage specifies data-item storage in binary format and may only be used at the 
elemental jevel. A PICTURE clause must accompany this usage. The amount of storage required by a 
computational data item is dependent on the number of decimal digits represented by its picture. 


Number of 
Decimal Digits Storage Required 


1 through 4 2 bytes 
5 through 9 4 bytes 
10 through 18 8 bytes 


3. COMPUTATIONAL-1 or COMP-1 usage specifies data-item storage in internal floating-point 
(short-precision) format, and requires four bytes of storage. tt may only be specified at the elemental 
level, and no PICTURE or VALUES clause may accompany this usage. 


4. COMPUTATIONAL-2 or COMP-2 usage specifies data-item storage in internal floating-point 
(long-precision) format, and requires eight bytes of storage. It may only be specified at the elemental 
level, and no PICTURE or VALUE clause may accompany this usage. 

5. COMPUTATIONAL-3 or COMP-3 usage specifies data-item storage in internal decimal (packed decimal) 
format, and may only be used at the elemental level. A PICTURE clause must accompany this usage. 
The amount of storage required by a COMPUTATIONAL-3 data item is equal to 1/2 of a byte (four 


bits), plus 1/2 of a byte for each decimal digit represented by the PICTURE, plus 1/2 of a byte (as 
required) to round the total required storage to the next whole byte. 


3.5.5.4. SYNCHRONIZED Clause 


Function: 


The schema DDL processor treats the SYNCHRONIZED clause as comments. DML preprocessor-generated 
record and data-item statements will not include synchronization. 


Format: 
SYNCHRONIZED 
SYNC. 
3.5.5.5. PICTURE Clause 
Function: 


The PICTURE clause describes the general characteristics of an elementary data item, and is required in all 
cases except where USAGE IS COMPUTATIONAL-1 or COMPUTATIONAL-2. 


Format: 


Pic 


PICTURE | 1S character-string 
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Rules: 


1. The character-string word represents the actual PICTURE and may be no more than 30 characters in 
length. 





2. The combination of PICTURE characters determines the category of data described by the PICTURE 
clause. The schema DDL processor recognizes two categories of data: alphanumeric and numeric. 
‘Alphabetic, alphanumeric-edited, and numeric-edited data categories are not recognized. 


3. Alphanumeric items are those whose character strings are restricted to the symbol X and an integer 
enclosed in parentheses representing consecutive appearances of X. Data items in this category must have 
a usage of DISPLAY, and if a VALUE clause is specified, the literal must be nonnumeric or a figurative 
constant. For example, the character string XXX describes three alphanumeric characters, and the 
character string X(6) describes six alphanumeric characters. ; 


4. Numeric items are further categorized into two types: fixed point and floating point. 


. Fixed-point numeric items are those whose character strings are restricted to the symbols 9, V, P, 
S, and an integer enclosed in parentheses to represent consecutive appearances of 9 or P. Data 
items in this category must have a usage of DISPLAY, COMPUTATIONAL, or 
COMPUTATIONAL-3. If a VALUE clause is specified, the literal must be numeric or one of the 
figurative constants ZERO, ZEROS, or ZEROES. Examples are: 


999 
Describes three numeric characters. 


g9V99 
Describes four numeric characters; V designates the position of the decimal point. 





$9(6)V99 : ; 
Describes eight numeric characters preceded by an operational sign; V designates the decimal 
point ({+} 999999.99). 


SVP(4)9(6) 
Describes 10 numeric characters preceded by an operational sign; V designates the decimal 
point; P(4) indicates that zeros are to be the four most significant characters following the 
decimal point ({t} 0000999999). 


$9(4) VP(6) 
Describes 10 numeric characters preceded by an operational sign; V designates the decimal 
Point; P(6} indicates the mumber of characters following the decimal point 
({+}9999.999999). 


a Floating-point numeric items are those whose character strings are restricted to the symbols +, —, 
9, V, (period), E, and an integer enclosed in parentheses to represent consecutive appearances of 
9. 


A floating-point display item has a picture string in the form: 

{£} mantissa € {+} exponent 

Data items in this category must have a usage of DISPLAY, and no VALUE clause may be 
specified. Only external floating-point items have variable picture formats; consequently, these 


items require a PICTURE clause. For internal floating-point data-item requirements, see the 
USAGE clause (3.5.5.3). 
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3.5.5.6. VALUE Clause 


Function: 

The VALUE clause specifies an initial value of an elementary data item, and may be stated whenever a 

PICTURE clause is specified except when the data item is of the external floating-point numeric category. In 

addition, no VALUE clause may be present on a data item which is of COMPUTATIONAL-1 or 

COMPUTATIONAL-2 usage, or a data item which redefines or is subordinate to one which redefines, or a data 

item which is occurred or is subordinate to one which is occurred. 

Format: 
VALUE IS literal 
Rules: 

1. The literal word represents the actual initial value desired and may be no more than 30 characters in 
length. The schema DDL processor recognizes figurative constants, nonnumeric literals, and numeric 
literals. 

2. A figurative constant may be substituted for a literal with the following restrictions: 


a. ‘The literal may be any figurative constant when the data-item PICTURE is alphar.umeric. 


b. The literal may be only one of the figurative constants ZERO, ZEROS, or ZEROES when the 
data-item PICTURE is numeric. 


3. Nonnumeric literals may be specified only when. the data-item PICTURE is alphanumeric. The literal 
must be enclosed in quotation marks (or apostrophes), and the number of enclosed characters must not 
exceed the number of characters represented by the PICTURE. . 

4. Numeric literals may be specified only when ‘the data-item PICTURE is numeric. The schema DDL 
processor does not validate the VALUE literal against the PICTURE character-string for correct format, 
decimal alignment, etc. The numeric literal is accepted as stated. 

3.5.5.7. OCCURS Clause 
Function: 

The OCCURS clause defines repetitive occurrences of group or elementary data items. 
Format: 

OCCURS integer TIMES 


Rules: 


1. Data items that are occurred and data items subordinate to ones that are occurred may not be named as 
control identifiers for CALC location mode storage (3.5.3) or for sorted sets. 


2. The integer word must be an unsigned number composed of from one to four numeric digits of the range 
2 through 9999. : 


ve tS 





8022 Rev. 1 SPERRY UNIVAC Series 90 an18 


UP NUMBER PAGE REVISION PAGE 


3.6.5.8. INDEXED Clause 


Function: 





The INDEXED clause may be specified only when an occurred data item and/or data items subordinate to one 
which is occurred are to be referenced by indexing, and for the same data item which bears the OCCURS 
clause. 
Format: 
"INDEXED BY index-name 


Rule: 


1. The index-name word must be a unique name and conform to the rules for formation of 
schema/subschema names. 


3.6. SET DESCRIPTION STATEMENTS 
Function: 


The set description statements define the relationship between two or more record types of a schema. 
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PAGE 





SET DESCRIPTION. 


Rules: 


SET NAME IS set-name. 


ORDER IS¢ NEXT p 





MODE IS CHAIN [LINKED TO PRIOR]. 
OWNER IS record-name 
NEXT DBKEY POSITION IS integer-1 


[PRIOR DBKEY POSITION IS integer-2] . 


MEMBER IS record-name 


MANDATORY AUTOMATIC 
OPTIONAL MANUAL 


[LINKED TO OWNER] 

NEXT DBKEY POSITION IS integer-1 
[PRIOR DBKEY POSITION IS integer-2] 
[OWNER DBKEY POSITION IS integer-3] 


(GEeecnonn 


DESCENDING KEY IS identifier 


DUPLICATES ARE { LAST 





Set description statements begin with a paragraph name composed of the words SET DESCRIPTION 
followed by a period and a space. Additional entries in the same line are ignored. The paragraph name is 
a required entry regardless of the presence or absence of other set type description statements. 


The description of a schema set is accomplished by entry of one each of the SET NAME, ORDER, 
MODE, and OWNER sentences, and a minimum of one MEMBER sentence. The SET NAME sentence 
must be the first for each schema set described, and the MEMBER sentence must be the last for each 
schema set. 
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3.6.1. SET NAME Sentence 





Function: 

The SET NAME sentence identifies by alphanumeric name, the set type being defined. 
Format: 

SET NAME IS set-name. 
Rules: 

1. The word SET may begin in the A or B area. 


2. The word set-name must be a unique name and conform to the rules for formation of schema and 


— subschema symbolic names (2.1.3). 


3.6.2. ORDER Sentence 
Function: 


The ORDER sentence specifies the insertion point of a member record occurrence within a set occurrence. 





Format: 
FIRST 
LAST 
ORDER IS< NEXT rs 
PRIOR 
SORTED 
Rules: 


1. The word ORDER may begin in the A or B area. 


2. FIRST is specified when the desired insertion point is immediately following the owner record 
occurrence. 


3. LAST is specified when the desired insertion point is immediately preceding the owner record 
occurrence. 


4. NEXT is specified when the desired insertion point is immediately following the current record 
occurrence of the set. 


5. PRIOR is specified when the desired insertion point is immediately preceding the current record 
occurrence of the set. 


6. SORTED is specified when the desired insertion point is to be determined by the value contained within 
a KEY control data item of the member record. 


7. When ORDER is PRIOR or LAST, prior linkage and data base key positions must also be specified. & 
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10. 


11. 


12. 


13. 
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If ORDER is SORTED, each set type member record definition must contain an ASCENDING or 
DESCENDING KEY identifier and DUPLICATES clause (3.5.5). 


If ORDER is FIRST, LAST, NEXT, or PRIOR, no MEMBER sentence in the same SET DESCRIPTION 
can contain the ASCENDING or DESCENDING clause. 


When ORDER is SORTED is specified for a given set, each MEMBER record must have an ASCENDING 
or DESCENDING clause to determine the order of MEMBER record occurrences of that type within a 


given set occurrence. 


When format 3 of the FIND statement, which is described in the DMS/90 data manipulation language 
manual, UP-8036 (current version), is used in the form 


FIND NEXT record-name RECORD OF set-name SET 


to pass through the MEMBER record occurrences in a set, only the records of the specified type are 
located, and they are located in the order specified by the ASCENDING or DESCENDING clause. 


When format 3 of the FIND statement is used in the form 

FIND NEXT RECORD OF set-name SET 
to pass through the member record occurrences in a set, all record occurrences of all types are located. 
The order of records of a given type is as specified in rules 11 and 12 when other record types are 
ignored. The order of a record of one type relative to a record of another depends upon the order in 


which each occurrence of each record was inserted into the set. MEMBER record occurrences are not 
grouped by record type. 


3.6.3. MODE Sentence 


Function: 


The MODE 1S CHAIN sentence specifies that all records participating in the named set are to be linked to the 
next record. 


Format: 


MODE IS CHAIN [LINKED TO PRIOR]. 


Rules: 


1. 


2. 


3. 


The word MODE may begin in the A or B area. 


If the optional LINKED PRIOR clause is entered, all records participating in the named set may be 
linked to the prior record. 


The LINKED PRIOR clause must be stated if the set ORDER is defined as PRIOR or LAST. 











8022 Rev. 1 SPERRY UNIVAC Series 90 A 3-18 


UP-NUMBER PAGE REVISION PAGE 


3.6.4. OWNER Sentence 


Function: © 


The OWNER sentence specifies the name of a record, the occurrence of which establishes the existence of a set 
and the relative position of data base keys within the control portion of the owner record of a set. Data base 
key values, which are inserted into the control portion of an owner record occurrence by DMS/90 at run-time, 
serve to link the owner to the first and, optionally, the last member record occurrence. 
Format: 
OWNER IS record-name 
NEXT DBKEY POSITION IS integer-1 
[PRIOR DBKEY POSITION IS integer-2] . 
Rules: 


1. The word OWNER may begin in the A or B area; additional clauses may be entered only in the B area. 


2. The record-name word must be the name of a record type previously defined in the record-type 
description statements. 


3. The integer-1 and integer-2 words must be unsigned numbers composed of no more than two numeric 
digits valued from 1 through 99. 


—_ 4. Data base key position numbers must be assigned according to the clock rule described in Appendix E. 





3.6.5. MEMBER Sentence 
Function: 


The MEMBER sentence specifies the name of a record, the occurrence of which may be a member of the 
named set. it also specifies the relative position of data base keys within the control portion of the member 
record. Data base key values, which are inserted into the control portion of a member record occurrence by 
DMS/90 at run-time, serve to link the member to the next member record occurrence and, optionally, to the 
prior member record occurrence and also, optionally, to the owner record occurrence. 


Format: 


MEMBER IS record-name 


MANDATORY| | AUTOMATIC 
OPTIONAL MANUAL 


[LINKED TO OWNER] 


NEXT DBKEY POSITION IS integer-1 
[PRIOR DBKEY POSITION IS integer-2] 
{OWNER DBKEY POSITION IS integer-3] 


ASCENDING | KEY IS identifier 
DESCENDING FIRST 
DUPLICATES ARE ) LAST 


NOT ALLOWED 
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The word MEMBER may begin in the A or B area; additional clauses may be entered only in the B area. 


The record-name word must be the name of a record type previously defined in the record-type 
description statements (3.5). 


Specification of the set membership type is accomplished by selection of the membership termination 
control parameter (MANDATORY or OPTIONAL) and the membership establishment contro! 
parameter (AUTOMATIC or MANUAL). See the DMS/90 data manipulation language programmer 
reference manual, UP—8036 (current version) for a detailed explanation of the use of the set 
membership type parameters. 


When the optional LINKED OWNER clause is entered, the named member record is linked directly to its 
associate owner record. If selected, the owner data base key position must also be specified for the 


member record. 


The integer-1, integer-2, and integer-3 words must be unsigned numbers composed of no more than two 
numeric digits valued from 1 through 99. 


Data base key position numbers must be assigned according to the clock rule described in Appendix E. 


The sorted set key identifier is specified by entry of the ASCENDING or DESCENDING KEY and 
DUPLICATES clauses. 


The identifier word must be the name of a data item defined within the named member record (group or 
elementary level), and may not be FILLER, redefining, or occurred, or subordinate to a data item that 


redefines or is occurred. 


Each occurrence of a member record can participate in only one occurrence of a given set type. 


3.7. PROCESSOR REPORTS AND SELECTION OPTIONS 


3.7.1. Processor Reports 


The schema DDL processor can produce five separate reports, all of which are generated to a single report output 
file. The following, is a list of reports in order of creation, with a brief description of each. 


2 Schema DDL Input Statement Listing 


The schema DDL input statement listing contains a full listing of all statements input to the processor (schema 
DDL and processor control statements). A processor assigned sequence number appears to the left of each 
printed input statement and is used in relating subsequent warning and error messages to specific statements. 
Figure 3—1 illustrates a sample schema DDL input statement listing. 


a Range Map Listing 


The range map listing shows, in sequence from low to high data base page number, the page range of the total 
schema, each area within the schema, and each record within their assigned area. This report may be produced 
or suppressed by user control entries. Figure 3—2 illustrates a sample range map listing. 
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COMPILED BY UNIVAC SERIES 90 SCHEMA COMPILER VERSION 01602 DATE 740425 


ee SCHEMA DDL INPUT STATEMENT LISTING == 





LINE SEQe SOURCE STATEMENT IDENTe 
000001 OOO!0O INCLST RNGMAP RECDES SETDES 
000002 000200e 


000003 0003006 PES HHFEOHOHEHSETSHORESERE OTOH RECHT HEHEHE BE RERH AEH ELE SESH EEE 
o0gc04 000400e * SCHEMA DESCRIPTION STATEMENTS e 
000005 ooosode FORRES HOSOHOHFTERESH HSE SHEEE SEH SEES SHE DEHHES OOH SEES ESD 


000006 o00600e 
000007 000700 SCHEMA DESCRIPTIONs 
000008 600800 


aoooa09 000900 SCHEMA NAME IS DMSSCHM RANGE IS 502 THRU 540. 
ooou10 001000 

000011 OO1L00 AUTHOR. OMS/90 PROGRAMMERSe 

g00012 001200 

000013 001300 DATE. O4/10/736 


ooo014 001400 

000015 001500 INSTALLATIONe SPERRY*UNIVAC BLUE BELLe 

aogog16 001600 

000017 001700 REMARKS. THIS IS THE DMS/90 SAMPLE SCHEMA. 
ooo0i8 001800 

000019 00:900¢ 


000020 O02000e SRS OHHEOHHSH THES ST OEEHEHEEOCEEERETEEHO RE EERESET ORS OED EO EE 
000021 002100¢ * AREA DESCRIPTION STATEMENTS ° 
000022 002200¢ POO OEHEFOEEEHHO ROOT OFESETEOHEHO SHEEP H EE HEVERE CES EOE ERS 


000023 002300¢ 
000024 OG2400 AREA DESCRIPTIONe 
000025 002500 


000026 002600 AREA NAME IS CUSTOMER@AREA RANGE 1[S 502 THRU 5106 
000027 002700 AREA NAME IS ORDER@=AREA RANGE IS 511 THRU 530. 
000028 002600 AREA NAME IS PRODUCT@AREA RANGE IS 531 THRU 5406 


000029 002900 
000030 0030006 


009031 003100 POOHEOHOHOOOOHOEEEHSOOEEECHEOHEEO REESE H EEO SHOH ED EEEM EES 
000032 003200 « RECORD DESCRIPTION STATEMENTS . 
000033 0033006 SOP EHEO HE SH RHE HOOERHET OREO EE ERE ORE OOH EEE EH ESE EHH ESET EES 


000034 003400 
000035 003500 RECORD DESCRIPTIONS 
000036 003600 





000037 003700 RECORD NAME CUSTOMER . 
000038 003800 RECORD 1d 6il ie 
000039 903900 LOCATION MODE CALC USING CUST=NO=61)1 DUPLICATES NOT ALLOWED. 
000040 004000 WITHIN CUSTOMER@AREA AREA, 
Goou4! 004100 
Q0004%2 004200 OS cCuSTeN0-611 PIC X(LI) de 
000043 004300 O95 CUST=-NAME=S=611 PIC X(35)6 
000044 004400 OS CUST#ADDR=S=61} PIC X(30)6 
000045 004500 OS CUST*CREDIT PIC XXXe 
000046 004600 OS FILLER PIC X(125)6 
000047 004700 
OG0U48 004800 RECORD NAME CUST=ORDER e 

A OGo049 004900 RECORD 1D 6206 


Figure 3—1. Sample Schema DDL Input Statement Listing 
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SCHEMA cccecccencrecntsssecsce OMSSCHM 





PAGE REVISION PAGE 


RANGE Map LIstine Seeereenantae 


00000502 aon0054an 


AREA, sees tansseone CUSTOMER@AREA ooo00so2 gn0005In 
RECORDe ee CUSTOMER 000008602 oO000R5In 
BREAsgeteceteeetocce OROER@AREA oeao00sil 0000053n 
RECORDece CUST@OROER ooce00si! o000053n 
RECORDece ORDER@1TEM o0000si! g000053, 
RECORDe ee ORD=REMARK ooo00s!i 90900053n 
AREA. ceneeteccteaces PRODUCTeAREA 00000533 OdO0n00S4n 
ReECORDecs PRODUCT 0000G531 doag00054n 


aeteewrerese RANGE MAP + IsTine PFaweenanst® age Exod 


Figure 3~2, Semple Range Map Listing 


Record Description Listing 


The record description listing restates all input entries for each record described; it also shows all data base key 
positions (3.5.5) that are assigned to the named record type. Special notation is also inserted on any data item 
which is used as a control identifier for CALC or a sorted set. Numbers appearing in the right margin are 
processor calculated values (number of characters or bytes), where RLGTH is the total record length (data 
base keys and data); KLGTH is the total length of all data base keys assigned to the record; DLGTH is the 
total length of the data portion of the record; and DSTRT is the data starting position relative to the beginning 
of the record (first character position is ZERO). For each data item, STRT is the data-item starting position 
relative to the beginning of the record and LGTH is the length of the data item. 


Figure 3—3 shows a sample record description listing. 


Set Description Listing 

The set description listing, for each set defined (CALC included), shows the owner and member record types 
assigned, the linkage, and for sorted sets, the control identifier and duplicate control statement. Figure 3—4 
shows a sample set description listing. , 


Warning and Error Message Listing 


The warning and error message listing comprises two parts; the first is a presentation of the actual messages 
where each message may be composed as follows: 


1. A processor-assigned sequence number of the statement for which the message was developed. 


2. Anerror severity code. Codes and associated descriptions follow: 


Code Description 


E Indicates an error that results in an 
unusable schema compilation. 


WwW Indicates a warning of a possibie 
error that will not hinder the 
resolution of the schema. - 
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RECORD NAME ccccoeee CUSTOMER 

RECORD [Deceveveves Ob)} 

LOCATION MODEseceeeelfALC USING 
WITHIN, cccccsccccese CUSTOMER=AREA 
OBKEY POSITIONScoce SETeccceceveccan 


OATA LTEMecocevcces 


Os 


os 
Os 
os 
05 


CUST-NO-6)1 


CUST=NAME=S=6)1 
CUST=ADOR=S-63 1 
CuSteCREOIT 
FILLER 


CALC 
OROOR 
REDEF INESccceces 


RECORD NAHE coerceee CUST©ORDER 
RECORD [Decscesesee 0429 

LUCATION MODEcee eee eC ALC USING 
WITHINccccccceseces ORDER@AREA 

OBKEY POSITIONSe cece SET eecvncececces 


DATA LTEMevccernece 


os 


os 
0s 
os 
os 
0s 
a5 


FO“N0-620 


CUST+P0-N0~620 
FILLER 
DATE=SHIP-620 
DATE“REQ~620 
OATE=PRHOM"620 
FILLER 


Catc 

ORDOR 
SPEC“REMARK 

{TEM 
REDEF INES cc cceee 


RECORD NAME cecccees ORDER@ITEM 
RECORD [Veccececvee 062} 

LOCATION MODEceeecoe VA SET 
WITHEINe ec evecccevee OROER@AREA 

DBKEY POSITEONScece SET eccceccvecvce 





ITé&m 


PROD=ORD 


mocer= RECORD DESCRIPTION LISTING evecee 


CUST-NO-611 
FROM 90000502 
TYPEos NEXT PRIOR OWNER 


THRY 00000510 


MEMBER t 2 
OWNER 3 4 
USACE vccccce VALUE ccc sncccccrecvccrtoesecveceteos PICTURE cere scccerecedeterererere 
OISPLAY xecha 
SET CONTROL ITEM FOR otewcwnn CALC 
OISPLAY x38) 
DISPLAY x(30) 
DISPLay AX 
OISPLAY nti25) 
FO-N0~620 
FROM 90000811 THRy 00000530 
TYPEoe NEXT PRIOR OANER 
MEMBER ' 2 
MEMBER 3 4 5 
OWNER é 7 
ORNER 8 9 
USAGE vedenes VALUE cvoescccccccroecetessceoevtoe PICTURE cee recccetosnceterererere 
DISPLAY x16) 
SET CONTROL ITEM FOR oceerern CALC 
SET CONTROL ITEM FOR eteecece ORDOR 
DISPLAY x08) 
DISPLAY MC27) 
DISPLAY ute) 
OUSPLAY nie) 
DISPLAY Rt6) 
OISPLAY nO1333 
ITE DISPLACEMENT OVOO PAGES 


FROM g0000533 
TYPEoe NEXT PRIOR OWNER 
MEMBER 1 2 3 
MEMBER § 5 6 


THRU 00000830 


Figure 3—3. Sample Record Description Listing 


@. 
. é 


ei 





RLOTH#O220 
KLGfHeools 
OLGeTH#9204 
ostrfaodié 


STRT LGTH 
cols ovli 


QU2Z7 GUIS 
vo0é2 ovsu 
vov2 oauds 
vuo%s 0826 


RLGTHe0Z40 
KLGTHsUOd6 
OLGTHRoZ04 
OstRreovad 


STRT LGTH 
0036 a008 


0044 0018 
0062 ou2} 
vosy gouudé 
00%S oguud 
oi101 gues 
aw7 o133 


RLGTHaQUPZ 
KLGTHs0U24 
DLGtHe0066 
ostrteou24 










L ‘A8y ZZ08 


Cc 
v 
2 

z 
¢ 
x 
o 
m 
a 


O06 S8LIBS AVAINN AWNSaAS 


NOISIASY 39V0d 
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SETeecece 
OwNER, 
MEMBER eee 
MEMBEReee 
MEMBER eee 


CALC 

SRI 
CUSTOMER 
CUST={ORDER 
PROUUCT 





SETeeseece 
OWNER sees 
MEMBERece 


ORDOR 
CUSTOMER 
CUST=ORDER 


SET ervece 
OWNERa cee 
MEMBER eae 


SPECHREMARK 
CUSTmORDER 
ORD=REMARK 


SETeeceece 
OwNEReese 
MEMBEReee 


rTes 
CUSTsORDER 
ORDER-ITEM 


SETevesee 
OWNERe wee 
MEMBERoee 


PROD#ORD 
PRODUCT 
ORDER@ITEM 


ogni 
oérl 
0620 
0631 


oe1l 
9620 


0620 
0622 


0670 
Q6al 


o6al 
uéa}t 


MODE IS CHAIN 

LINKED NEXT PRIOR 
LINKED NEXT PRIGK 
LINKED NEXT PRIOR 
LINKED NEXT PRIOR 


MODE IS CHAIN 
LINKED NEXT PRIOR 
LINKED NEXT PRIOR 


MODE IS CHAIN 
LINKED NEXT PRIOR 
LINKED NEXT PRIOR 


MODE IS CHAIN 
LINKED NEXT PRYOR 
LINKED NEXT PRIOR 


MODE IS CHAIN 
LINKED NEXT PRIOR 
LINKED NEXT PRIOR 
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OWNER 


OwNER 


OWNER 


ORDER IS SOnTEv 


MANDATORY AyTOMATIC 
MANDATORY AUTOMATIC 
MANDATORY AUTOMATIC 


CuSTeNO=,11 
ForNow62i, 
PROD=NO=,431 


ASC 
asc 
asc 
ORDER 15 sOxTED 
MANDATORY AUTOMATIC aSC FueNo=é2en 
ORDER IS (AcT 

OPTIONAL MaWuAL 
ORDER IS vExT 
MANDATORY AUTOMATIC 
ORDER 15 sOKTED 
OPTIONAL AUTOMATIC aSC LoT*NO=671 


SET DESCRIPTION LISTING 


Figure 3—4. Sample Set Description Listing 
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HUP 
oP 
uP 


ruP 





NOT 
NOT 
NOT 


NOT 





PAGE 





ALLOWFU 
ALLOWEU 
ALLOWED 


ALLOWED 


DUP NOT alLbLOngu 


3. An S/message. This message relates what the processor was scanning or searching for. 


4. An F/message. This message relates what the processor found. 


5. A D/message. This is the actual diagnostic message (what was wrong). 


6. An A/message. This message indicates the action to be taken by the processor or, in some cases, the 
possible user action to be taken. 


The second part of the listing totals the number of processor messages by severity code and issues a statement 
concerning the usefulness of the schema for subschema processing. Figure 3—5 shows two sample warning and 
error message listings. In Figure 3—5a, the printout indicates that there are no error or warning messages. 
Figure 3—5b lists E-level and W-level messages in the first part and an explanation in the second part. 


3.7.2. Report Selection Options 


The schema DDL processor generates all five reports described in 3.7.1 unless E-level errors are detected or unless 
input statements described as follows are specified prior to the SCHEMA DESCRIPTION paragraph name. If E-level 
errors are detected, the range map, record description, and set description listings are not printed. 








-- WARNING AND ERROR MESSAGE LISTING --- 


NO ERROR AND/OR WARNING MESSAGES ISSUED 
SUBSCHEMA PROCESSING ALLOWED 


-- WARNING AND ERROR MESSAGE LISTING --- END 


a. No error or warning messages issued 


-- WARNING AND ERROR MESSAGE LISTING --- 


NNNNNN_ E_ S/ASC, DSC KEY IDENTIFIER F/SORTED SET D/UNDEFINED A/REQUIRED ENTRY 
Sequence Processor Scanning Found Diagnostic User Action 
Number For To Be Taken 

Error 

Severity 

Code 
NOTE: 


In this sample listing, the schema processor was searching for the ascending or descending key 
identifier in the SET DESCRIPTION and did not find it. Because this is a required entry, an 


E-level diagnostic is produced, resulting in an unusable schema compilation, 
-- WARNING AND ERROR MESSAGE LISTING --- 


LINE SEQ. SOURCE STATEMENT IDENT. 
00023n E LEVEL MESSAGES ISSUED 
000018 W LEVEL MESSAGES ISSUED 
SUBSEQUENT JOBSTEPS CANCELED 
SUBSCHEMA PROCESSING DISALLOWED 


-- WARNING AND ERROR MESSAGE LISTING --- END 


b. E-level and W-level messages issued 


Figure 3—5. Sample Warning and Error Message Listings 
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The following features are available to alter the report selection defaults: 
a Sequence Check Feature 
This feature may be nullified by specifying the word NOSEQ beginning in column 8. 
5 E-level Error Message Listing 
To override report suppression when E-level errors occur, specify INCLST beginning in colurnn 8 followed by 
a 6-character abbreviated name for each of the desired reports to be included in printing. Acceptable 
abbreviated report names are: 
RNGMAP -— for the range map listing 
RECDES ~ for the record description listing 
SETDES — for the set description listing 
s Suppressing Report Listings 
The programmer can suppress the listing of a range map listing, a record description listing, or a set description 
listing, provided no E-level severity-code errors occur. This suppression is accomplished by specifying STPLST 
beginning in column 8 of an input statement followed by the 6-character abbreviated name for each report to 
be omitted from the printing. Acceptable abbreviated report names are the same as those given in the 


preceding paragraph. 


Examples of the use of input statements are given in Appendix D. 
































@ 
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4. Subschema Data Description Language 


4.1. GENERAL 

The subschema data description language (subscherna DDL) is a subset of the April 1971 CODASYL Data Base Task 
Group language specification, and is used to describe a portion of the total schema (selected areas, records, and sets) 
which is of interest to one or more application programs. In addition, the resultant subschema is in a form 
compatible with the application program. 

The subschema DDL described in the following text is for writing a subschema compatible with application 
programs written in COBOL. 

4.2. ORGANIZATION OF THE SUBSCHEMA DDL 


The subschema DDL is composed of the following two groups of statements: 


1. Subschema identification division statements 
2. Subschema data division statements 


Each statement group must appear in the sequence shown; each describes a specific aspect of the subschema. The 
latter group relies on the first for identification. ; 

Each group begins with a divisional paragraph name. The processing of statements for a group begins with its 
paragraph name and is terminated by the next paragraph name or the end of the statement input stream. 

in addition to DDL statements within the two groups mentioned, optional input sequence check and report control 


parameter statements (4.5) may be entered in the statement input stream prior to the subschema identification 
division statements. 


4.3. SUBSCHEMA IDENTIFICATION DIVISION STATEMENTS 
Function: 


Subschema identification statements identify the subschema and, at the user’s option, may identify the 
subschema author, the date of its creation, the user installation, and may present any other desired remarks. 





PAGE REVISION PAGE 
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Format: 
Area Area Area 
A AorB B 


SUBSCHEMA IDENTIFICATION DIVISION. 


SUBSCHEMA NAME IS subschema-name <—> [Pen | 


OF SCHEMA NAME schema-name. 


[AUTHOR. [comments] .] 
(DATE. [comments] .] 


[INSTALLATION. [comments] .] 





[REMARKS. [comments] .] 
Rules: 


1. Subschema identification division statements begin with a paragraph name composed of the words 
SUBSCHEMA IDENTIFICATION DIVISION followed by a period and a space. Additional entries in the 
same line are ignored. 


2. The SUBSCHEMA NAME sentence must immediately follow the words SUBSCHEMA 
IDENTIFICATION DIVISION and must be the only occurrence of the sentence within the subschema 
DDL input stream. 





3. The remaining optional paragraphs and associated entries may appear in any desired sequence. 


4.3.1. SUBSCHEMA NAME Sentence 
Function: 
The SUBSCHEMA NAME sentence identifies the subschema being described. 
Format: 
SUBSCHEMA NAME IS subschema-name OF SCHEMA NAME schema-name, 
Rules: 


1. The word SUBSCHEMA begins in the A area; subsequent words of the sentence-agit continue in the B 
area of the same eFeuhsequentdrtes, UINe, 6uT MAT Vor comtewve Ewe SUSSEQVEewT LIWES 6 {fen 5| 


2. The subschema-name word must be a unique name composed of one to eight alphanumeric characters, 
the first of which must be a letter. 














MVeem Tov. § wre Ge FES WIE PN WU Ie Ww 
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NOTE: 

& If a subschema-name is not unique (another subschema was previously defined and identified with the same 
name), the DDL processor assumes that a redescription of the subschema is desired and deletes the existing 
subschema replacing it with the new one. If errors are detected in the new subschema DDL, the system is left 
with no usable subschema identified by subschema-name. 


3. | The schema-name word must be the identifying name of the schema. 


4.3.2. AUTHOR Paragraph 


Function: 


The AUTHOR paragraph is treated as a comment entry and is presented on the processor input statement 
listing. 


Format: 


AUTHOR. [comments] . 


4.3.3. DATE Paragraph 

Function: 

The DATE paragraph may be used to specify a subschema date of creation other than the computer date. If 

6 the date override feature is not desired, the DATE paragraph must be omitted entirely and computer date will 

be assumed for subschema date of creation. 

Format: 
DATE. date-entry. 

Rules: 

1. The word DATE begins in the A area and must be followed by a period and a space. 

2. The date-entry must accompany the DATE paragraph name and begin in the B area of the same line. The 
date-entry must be eight characters in the form mm/dd/yy, where mm, dd, and yy are the month, day, 
and year numbers, respectively. - 

4.3.4. INSTALLATION Paragraph 
Function: 


The INSTALLATION paragraph is treated as a comment entry and is presented on the processor input 
statement listing. 


Format: 


@ INSTALLATION. [comments] . 
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4.3.5. REMARKS Paragraph 


- 


Function: 





The REMARKS paragraph is treated as a comment entry and is presented on the processor input statement 
listing. 


Format: 


REMARKS. [comments] . 


4.4. SUBSCHEMA DATA DIVISION STATEMENTS 
Function: 


The subschema data division statements name the areas, records, and sets that are to be contained in the 


subschema. 

Format: 
Area Area Area 
A AorB B 


SUBSCHEMA DATA DIVISION. 





AREA SECTION. 

COPY area-name AREA. 
RECORD SECTION, 

COPY record-name RECORD. 
SET SECTION. 

[COPY set-name SET.] 


Rules: - 
1. Subschema data division statements begin with a paragraph name composed of the words SUBSCHEMA 
DATA DIVISION followed by a period and a space. Additional entries in the same line are ignored. 


2. The remaining statements of this division are divided into three sections: AREA, RECORD, and SET. 
Each section is composed of a paragraph name and associated COPY statements. 


3. The sections of the data division must be coded in the sequence shown, each naming component parts of 
the subschema, and each relying on named parts from the prior section or sections. 


4. Processing of statements for a specific section begins with its associated paragraph name and is 
terminated by the following pargraph name or end of statement input stream. 











mev. i rt Bes BEGG eI ee ww Iw ww 
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4.4.1. AREA SECTION Statements 

Function: 
AREA SECTION statements are used to name those areas of the total schema that are to be included in the 
subschema being described. These statements comprise one AREA SECTION statement and one or more 
COPY AREA statements. 

Format: 
AREA SECTION. 


COPY area-name AREA. 


Rules: 


1. The section begins with a paragraph name composed of the words AREA SECTION followed by a 
period and a space. Additional entries in the same line are ignored. 


2. The COPY AREA statement names a schema area that is to be included in the subschema being 
described. 


3. A minimum of one COPY AREA sentence must be entered for a subschema; if more than one is entered, 
only one sentence per input line is permitted. 


4. The word COPY may begin in the A or B area. 


5. The area-name word must be the name of a previously defined area of the schema. 


4.4.2. RECORD SECTION Statements 

Function: 
RECORD SECTION statements are used to name those record types of the total schema that are to be 
included in the subschema being described. These statements comprise one RECORD SECTION statement and 
one or more COPY RECORD statements. 

Format: 
RECORD SECTION. 
COPY record-name RECORD. 


Rules: 


1. The section begins with a paragraph name composed of the words RECORD SECTION followed by a 
period and a space. Additional entries in the same line are ignored. 


2. The COPY RECORD statement names a schema record type that is to be included in the subschema 
being described. 


3. A minimum of one COPY RECORD sentence must be entered for a subschema; if more than one is 
entered, only one sentence per input line is permitted. 
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4. |The word COPY may begin in the A or B area. Ss 





5. The record-name word must be the name of a previously defined schema record type, the actual data 
base occurrence of which was described as being within an area named in the AREA SECTION 
statements. 


4.4.3. SET SECTION Statements 
Function: 
SET SECTION statements are used to name those set types of the total schema which are to be included in the 


subschema being described. These statements comprise one SET SECTION statement and, at the programmer’s 
option, one or more COPY SET statements. 


Format: 
SET SECTION. 
[COPY set-name SET.] 
Rules: 


1. The section begins with a paragraph name composed of the words SET SECTION followed by a period 
and a space. Additional entries in the same line are ignored. 


2. The SET SECTION paragraph name is required regardiess of the presence or absence of COPY SET 
sentences. 





° 


3. The COPY SET statement names a schema set type that is to be included in the subschema being 
described. 


4. The COPY SET statement may be omitted if the set relationships between record types are not desired 
or needed by the application program using the subschema. If entered, only one COPY SET sentence per 
input line is permitted. 


5. The word COPY may begin in the A or B area. 


6. The set-name word must be the name of a previously defined schema set. In addition, the owner record 
(3.6.4) and at least one member record (3.6.5) of the set-name type must have been named in the 
RECORD SECTION statements. 


7. All set relationships in which a specific data base record is involved must be defined in the subschema 
being run, if in that run, the modification (STORE, MODIFY, DELETE) of the specific record is 
desired. 


8. It is possible and often desirable to describe a subschema where afl set relationships for a given record or 
all records for a given set relationship are not included in the subschema. The subschema processor 
recognizes either of these conditions and marks the object subschema record description as protected 
from run modification. 
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4.5. PROCESSOR REPORTS 


& The following is a list of reports, in order of occurrence, that can be produced during, and resulting from, the 
processing of subschema DDL statements. A brief description of each report is given and, where required, conditions 
determining the presence or absence of a report are noted. 


I] Source DDL Input Listing 


As input statements to the processor are processed and checked for proper sequence, a source DDL input 
listing is generated. Any errors detected at this point are acknowledged by a message appearing to the right of 
the statement in error. The sequence check feature can be overridden by specifying NOSEQ beginning in 
column 8 of an input statement placed before the subschema identification division paragraph name 
statement. 


Figure 4—1 illustrates a sample subschema DDL input statement listing. 


i] Errors Detected During Network Analysis 


A listing of errors detected during network analysis may result if complete analysis of the defined subschema 
reveals that erroneous relationships between areas, records, or sets were attempted. Further processing is 
stopped and an error severity level associated with the subschema DDL processor is printed. There are three 
levels of error severity: 


Level Description 
f- 1 Warning level error; requires user investigation. Processing continues. 
3 Serious level error; the compilation continues, but usually more serious 


errors result during subsequent processing. Execution of the object . 
program, in general, gives unpredictable results. 


9 Terminal level error; processing is halted. 


tf no errors or only minor errors are detected, processing would continue resulting in the creation of 
statements that are to be inserted by the data manipulation language (OML) preprocessor into the working 
storage and procedure division areas of COBOL programs invoking the named subschema. 


{f no errors or only minor errors are detected, the following reports are produced: 

a Subschema Data Records 
This report lists all records (01 level entries) and associated group and elemental data-item statements included 
in the named subschema. Figure 4--2 shows a sample listing of subschema data records. 

| Record Definition Entries 


This report lists all record name constant statements included in the named subschema. Figure 4-3 shows a 
sample listing of record definition entries. 
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COMPILED BY UNIVAC SERIES 90 SUBSCHEMA COMPILER VERSION 092700 DATE 7404925 ss 


SOURCE DOL INPUT LISTINGs 








SEQs SOURCE STATEMENT IDEN. 
0001006 
G0o0200e SPHOSCOSHHSH EH SESHOSHSSEOCEEEESCOLEOSOEE HERO ECESEOOE SEER OOES 
000300e ° SUBSCHEMA IDENTIFICATION STATEMENTS ° 
Oo04O0e SPCHHCSOHSSH TES HE STSLOSSSSHSHSTSSOSCSHSHHE SESE SSHHOSCHEEOEERSOOE 
G00800¢ 
000600 SUBSCHEMA IDENTIFICATION DIVISIONe 
000700 
GOD800 SUBSCHEMA NAME IS DMSSUBS OF SCHEMA NAME ONSSCHMe 
000900 
OO1;LCO AUTHOR. OMS/90 PROGRAMMERS, 
003100 
004,200 BATE. 04/10/73-6 
004300 
GO140O INSTALLATION, SPERRYOUNIT VAC BLUE BELLe 
003500 
00:600 REMARKSe THIS IS THE OMS/90 SAMPLE SUBSCHEMAe 
001760 
001: 800e 
00;9000 COSHOOSH SHES ESEHHSESSEHHOHHSESHSOSECOSHSCEESH SEH EESEELEEE 
oo2ba0e e SUBSCMEMA DATA STATEMENTS ° 
002100¢e SCOHSOHSSHHSESEEHEESOHESEHSCSSHEHE SESH LHEHSSOHECEOH SESH SOLESED 
0022006 
002300 SUBSCHEMA DATA DIVISION. 
062400 
OO2Z500 AREA SECTION. 
002600 
002700 COPY CUSTOMER@AREA AREA’ 
002800 COPY ORDER@AREA AREAe 
002900 COPY PRODUCTeAREA AREAe 
003000 
003100 RECORD SECTION. 
603200 
903300 COPY CUSTOMER RECORD. 
003400 COPY CUST=ORDER RECORD. 
003500 COPY ORDER@ITEM RECORD. 
003600 COPY ORD-REMARK RECORD. 
003700 COPY PRODUCT RECORDe 
003800 
OO39700 SET SECTIONe 
004000 . 
004100 COPY ORDOR SETe 
004200 cory ITEM SETe 
GO4300 COPY SPEC@REMARK SETe 
OOa400 COPY PROD@ORD . SET 
0048500 


Figure 4—1. Sample Listing of Subscheme DDL Input Statements 
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2: SUBSCHEMA DATA RECORDS. 


@ Ol CuSTOMER, 





0S CUST=#No=4it Pre 
O5 CUST«NAME*Seo1} Pic 
05 CUST=ADDR=S-611 e1c 
OS CUSTeCREDIT Pre 
OS FILLER PIC 
O1 CusreORDER, 
O05 FO=-N0=420 Pre 
05 CUST<Po=N00670 pic 
OS FILLER PIC 
OS DATEoSnIP2620 Pic 
0S DdDATEREQG620 Pre 
OS DATESPROM@62U PIC 
OS FILLER exc 
OL ORDeR@ITEM, 
OS PRODeNG-421 PIC 
OS FILLER ‘ PIC 
OS LOT=N0.621 Pic 
OS FILLER Pre 
OS BTY=0RD~42) COMPay etc 
OS QTYeSH1Pe62) COMP e3 PIC 
OS FILLER pic 
Ol ORDeRENARK, 
03 ORDONEM@CD=622, 
OS REMARK.CD@622 PIC 
OS REMARKSSEQ2622 PIC 
OS REMARK2622 Pic 
OS FILLER PIC 
Gl PRONUCT. 
OS PROD=Nn=431 PIC 
OS FILLER PIC 
05 PRODWDESoINT W641 Pic 
O05 PROD@DESHEXT~631 PIC 
ao OS FILLER Pic 
a 
( ® Figure 4-2. Sample Listing of Subschema Data Records 
RECORD DEFINITION ENTRIES. 
Ot OMSsuBS=RECORDS. 
G3 SRé1i PIC nebo? VALVE +CUSTOMER 
03 SRé20 PIC Xie) VaLVE *CUSTSORDER 
03 $R624 PIC x¢i6) VALUE +tORDER@TTEM 
63 SRe22 PIC X¢36) VALUE *ORDeREMARK 
03 $R63) ; PIC xCl@) VALUE ePRODUCT 


Figure 4-3. Sample Listing of Record Definition Entries 


a Area Definition Entries 


RCV). 
KU3S5)6 
R130). 
KKK. 

44125) 


XCBd. 
RC1lBde 
RC27be 
Rlbbe 
Riode 
Klbde 
40133) 


ROL) 
AER, 
RUFde 
RCW. 
S917). 
SOC7)6 
RUG). 


he 

Re 
AU7S)6 
KXX, 


RGUL2)6 
Rke 

XOLSde 
ACID « 
KtUS3)6 


PAGE REVISION PAGE 


This report lists all area name constant statements included in the named subschema. Figure 4—4 shows a 


sample listing of area definition entries. 


AREA DEFINITION ENTRIES. 


Ul OmSsuBS-aREase 


O3 CUSTOMER-AREA PIC xi36) VALVE *CUSTOMER@AREA 
@ O03 OROER@aREA PIC x(16) VALUE *ORDERAREA 
O03 PROOUCTOAREA PIC £016) VALVE #PRODUCTOAREA 


Figure 4—4. Sample Listing of Area Definition Entries 
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a Set Definition Entries 





This report fists all set mame constant statements included in the named subschema. Figure 4—5 shows a & 
sample listing of set definition entries. 


SET DEFINITION ENTRIES. 


Ol DmeScusS-SErsS, 
03 oRDOR PIC x¢36) VALUE eOKDOR 


i] 
O03) «ITEM ; PIC K( 16) VALUE eITEM “ 
O03 SPECeRemMaRK PIC X016) VALUE @SFECoWEMARK ‘, 
O03 PROD-OrDd PIC x¢i6) VALUE «PROD-ORD . 
O03 care PIC xCl@) VALUE eCatc . 


Figure 4—5. Sample Listing of Set Definition Entries 


a DMS/90 Bind Calls 


This report lists all procedural call statements used in establishment of address linkage. Figure 4—6 shows a 
sample listing of DMS/90 bind calls. 


OBMS BIND CALLG, 


CALL "XR7DMS* USING 1DBMSCOM (59) OMSSUBSH@CTKL, 
CALL *xR7OMS* USING [OBMSCOM (48) SRoil CUSTOMER, 
CALL *XR7DOMS*® USING ;DOBMSCOM (1) CUSTeND@Wb11 

SRO1] CALCe 
CALL *xR7GMS* USING IDBMSCOM (496) SREZ20 CUST@ORDER: 
CALL XR7OMS* USING TOBMSCOM (1) FOXNO~620 

SR620 CALCe 
CALL "xR7DMS* USING TOBMSCOM (3) FOND=620 

SRE20 ORDO: 
CALL *ZzR7OMS* USING TOBMSCOM (498) SRO21 ORDEROI TEM. 
CALL °XR7OMS* YSING 1DBMSCOM (1) LOTeNO~62) 

SRO21 PROO-ORD, 
CALL "xR7OMS* USING IDBMSCOM (98) SREZZ2 ORVOREMARK. 
CALL *XR7OMS* USING IDBMSCOmM (46) SR6E31 PRUDUCT, 
CALE "ZR7OMS* USING TOBMSCOM (1) pPROD@NO-63) 

SRO31 CALCe 





Figure 4—6. Sample Listing of DMS/90 Bind Calls 


Normally, a list of assembler input statements from the subschema DDL processor is suppressed, but, at the 
programmer's option, this list may be printed by specifying the words LIST NETWORK beginning in column 8 of an 
input statement. This input statement must be placed before the subschema identification division paragraph name 
statement. 


The assembler input statements listing is the last report resulting from the processing of subschema DDL statements, 
and bears the title SUBSCHEMA subschema-name NETWORK DEFINITION TABLES. 
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Appendix A. DMS/90 List of Reserved Words 


A.1, RESERVED WORD LIST 


ACTUAL DATA HIGH-VALUE 
ALIAS DATA-BASE-KEY (DBKEY) HIGH-VALUES 
ALL DATE . 
ALLOWED DECIMAL (DEC) IDENTIFICATION (ID) 
ALTER DECODING IDENTIFIED 
ALWAYS DEFINED IMMATERIAL 
AND DELETE IMPLEMENTOR 
ARE DEPENDING IN 
AREA DESCENDING (DESC) INDEX 

: AREAS DESCRIPTION INDEXED 
(® AREA-CODE DIRECT INSERT 
AREA-ID DIRECT-DBK INSERTION 
ASCENDING (ASC) DISPLACEMENT INSTALLATION 
AUTHOR DISPLAY INTO — 
AUTOMATIC (AUTO) DIVISION INVOKE 
DUPLICATE (DUP) is 

BINARY (BIN) DUPLICATES (DUPS) 
BIT DURING KEY 
BY DYNAMIC KEYS 
CALC 
CALC-KEY EMPTY LAST 
CALL ENCODING LEADING 
CHAIN EQUAL LINKED 
CHANGED ERROR LOCATION (LOC) 
CHARACTER (CHAR) EXCLUSIVE (EXCL) LOCK 
CHECK LOCKS 
CLOSE FILLER LOW-VALUE 
COMMENT FIND LOW-VALUES 
COMPILE FIRST 
COMPLEX FIXED MANDATORY (MAND) 
COMPUTATIONAL (COMP) FLOAT MANUAL 
COMPUTATIONAL-1 (COMP-1) FOR MEMBER 
COMPUTATIONAL-2 (COMP-2) FROM MEMBERS 
COMPUTATIONAL-3 (COMP-3) MODE 
COPY GET MODIFY 


CURRENT 


MOVE 





8022 Rev. 1 
UP-NUMBER 


SPERRY UNIVAC Series 90 






NAME REAL TEMPORARY (TEM) 

NEXT RECORD THEN 

NON-EXCLUSIVE (NEXCL) RECORD-NAME THIS 

NOT REDEFINES THROUGH 

NULL REMARKS THRU 
REMOVE TIMES 

OBTAIN RESULT TO 

OCCURRENCE RETRIEVAL (RETR) TRAILING 

OCCURS RUN-UNIT TYPE 

OF 

ON SCHEMA UPDATE 

ONLY SEARCH USAGE 

OPEN SECTION USAGE-MODE 

OPTIONAL (OPT) SELECTION USING 

OR SELECTIVE 

ORDER SEPARATE VALUE 

OWNER SET VALUES 
SETS VIA 

PAGES SIGN VIRTUAL 

PERMANENT SORTED 

PICTURE (PIC) SOURCE WHERE 

POINTER-ARRAY (PTR) SPACE WITHIN 

POSITION SPACES 

PRIOR SR1 ZERO 

PRIVACY SR6 ZEROS 

PROCEDURE (PROC) STATUS ZEROES 

PROCESSABLE STORE 

PROTECTED (PROT) SUBSCHEMA 


RANGE 


A.2. RESTRICTED DATA NAMES AND PROCEDURE NAMES 


SYNCHRONIZED (SYNC) 
SYSTEM 


The following words are restricted from arbitrary usage by the user. The words are data names and procedure names 
with special meanings described in the data manipulation language programmer reference manual, UP-8036 (current 


version). 


AREA-NAME 
CURRENCY 
DMS-ABORT 
DMS-STATUS 
DMS-SUCCESS 
ERROR-AREA 
ERROR-RECORD 
ERROR-SET 
ERROR-STATUS 
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Area | Area Area 
A AorB B 


SCHEMA DESCRIPTION. 


SCHEMA NAME IS schema-name 
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Appendix B. Schema DDL Syntax 


[RANGE IS integer-1 THRU integer-2]. 


{AUTHOR. [comments] .] 
[DATE. date-entry.] 


[INSTALLATION. [comments] .] 


[REMARKS. [comments] .] 


AREA DESCRIPTION. 


AREA NAME IS area-name 


RANGE IS integer-1 THRU integer-2. 
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Area Area Area 


A AorB B @ 


RECORD DESCRIPTION. 


RECORD NAME IS record-name. 
RECORD ID IS integer. 
LOCATION MODE 5S 





e 
-~- 


DIRECT FIRST 
CALC USING identifier DUPLICATES ARE | LAST 
VIA set-name SET NOT ALLOWED 


WITHIN area-name AREA. 


data-name-1 
lvel-umber | FILLER 


[RBEDEFINES data-name-2] 














ISPLAY 
COMP 
COMPUTATIONAL 
COMP-1 
[USAGE !S] COMPUTATIONAL-1 

COMP-2 
COMPUTATIONAL-2 
COMP-3 
COMPUTATIONAL-3 

| SncHRONIzED | 

SYNC 
EieTWas tS character-string] 


[VALUE IS literal] 
[OCCURS integer TIMES] 
{INDEXED BY index-name]. 
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SET DESCRIPTION. 
SET NAME IS set-name. 
FIRST 
LAST 
ORDER IS4 NEXT 2 





SORTED 
MODE IS CHAIN [LINKED TO PRIOR]. 
OWNER IS record-name 
NEXT DBKEY POSITION IS integer-1 
[PRIOR DBKEY POSITION IS integer-2] _ 
MEMBER IS record-name 
mapa eRY | AUTOMATIC 
OPTIONAL MANUAL 
[LINKED TO OWNER] 
NEXT DBKEY POSITION IS integer-1 
{PRIOR DBKEY POSITION IS integer-2] 
{OWNER DBKEY POSITION IS integer-3] 


[ asceNune . spe 
DESCENDING KEY 1S identifier 


FIRST 
DUPLICATES ARE 





LAST 


4 < 
\ @ 


NOT ALLOWED 


|} 
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e 
Appendix C. Subschema DDL Syntax 


Area | Area Area 
A Aors 8 


SUBSCHEMA IDENTIFICATION DIVISION. 
SUBSCHEMA NAME !S subschema-name 
OF SCHEMA NAME schema-name, 
[AUTHOR. [comments] .] 
(DATE. [comments] .] 
[INSTALLATION. [comments] .] 
[REMARKS. [comments] .] 
SUBSCHEMA DATA DIVISION. 
AREA SECTION. 
@ COPY area-name AREA. 
RECORD SECTION. 
COPY record-name RECORD. 
SET SECTION. 


[COPY set-name SET.] 



































? 
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Appendix D. Sample Schema and 
Subschema Definitions 


D.1. GENERAL 


Sample schema (DMSSCHM) and subschema (DMSSUBS) data definitions for an inventory-oriented data base are 
shown in this appendix. The sample data manipulation language (DML) program appropriate to the subschema is 
shown and explained in the data manipulation language programmer reference manual, UP-8036 (current version). 


vt 
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D.2. THE SCHEMA DEFINITION (DMSSCHM) ran 





OGO1GO INCLST RNGMAP RECDES SETDES 





Oo002z00¢ 

oo0o0300e SOS PSS HSSSCHRSSCHHSOSSSHSESSSHSSEHHSOESECSH EO HELESHESESHCE EE ROS 
oo0#¢00¢ e SCHEMA DESCRIPTION STATEMENTS e 
oocosdoe SOS esF ESSE oS HSSESES SSHESCHSESCESSES SESE SHFHSESSEECRSES SHH EH EES 
ocoé00¢ 

000700 SCHEMA DESCRIPTION. 

000600 

000900 SCHEMA NAME 3S OMSSCHM RANGE [5S 502 THRU 540. 
001000 

QO1100 AUTHOR. DMS/90 PROGRAMMERSe 

601200 

001300 DATE. O4/10/736 

001400 

001800 INSTALLATION, SPERRYeUNI VAC BLUE BELL, 

001600 

001700 REMARKS, THIS IS THE D0mMS/90 SAMPLE SCHEMA 

001800 

0017006¢ 

oo2000e PESO SFSSES SHE STSEHCHH SSESOHHEOHSEHESSCESESHE SEF ESEHE ESOS ESE HH Ee 
0021000 . AREA DESCRIPTION STATEMENTS ° 
oo22008 SPOS e eFC SESS HSSHOSSSHE SHSESESLESSEOSSHCOCHEHSSSCHSSEFHROHLESHESOHOSES ES ESE 
002300¢ 

002400 AREA DESCRIPTION. 

002500 

002600 AREA NAmE IS CUSTOMER@AREA RANGE 15 502 THRU 510, 
002700 AREA NAmE IS ORDER@AREA RANGE 15 51) THRU 530, 
002800 AREA NAME IS PRODUCT©AREA RANGE 15 53) THRU 540, 
002900 

0o3000¢ 

003100e FER SSESSCHESHSCSEHRHSHE SEHESHHSHESSEHEHSHHLSESHE HR GFECHESECHEOE ROSES EHS 
O03200¢ e RECORD DESCRIPTION STATEMENTS ° 
Q003300e FSS SSCHSESMSSSSOHSSHSHSESSSSCESHESESHSCHSOES HES HH REOHSEO RHR ETRE 
0o3400¢ 

003500 RECORD DESCRIPTION. 

003600 

003700 RECORD NAME CUSTOMER r) 

0038090 RECORD 30 61} 6 

003900 LOCATION MODE CALC USING CUSTeNO-6)1 DUPLICATES NOT ALLOWEDe 
004000 WITHIN CUSTOMER@AREA AREA, 

004100 

004200 OS. CUST=No-611 PIC XC31))6 

004300 O05 CUSTeNAMNE@S—61)} PIC X(35).6 

004400 OS CUST-ADOR=S-61} PIC X(30). 

004500 OS CUST-CREDIT PIC XXKe 

004600 OS FILLER PIC X(325)~6 
004700 

004809 RECORD NAME CUST=ORDER ® 

004909 RECORD 10 620° 

GOS009 LOCATION MODE CALC USING FO"N0Q0620 DUPLICATES NOT ALLOWED, 


005100 WITHIN ORDER@AREA AREA, 
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005200 
005300 
005400 
005500 
0054600 
005700 
005800 
005900 
6060090 
006100 
006200 
006300 
006480 
006500 
006600 
006700 
006800 
006900 
007000 
007100 
007200 
007300 
007400 
007500 
007609 
007700 
007800 
007900 
cosecag 
006100 
008200 
008300 
008400 
008509 
008600 
00870D 
006800 
008900 
009000 
009100 
009200 
009300 
009400 
009500 
0096006 
009700 
0o097800e 
0099006¢ 
010000e 


QOS FO-NO-620 

05 CUSTaPQ"#NO2620 

OS FILLER 

OS DATE@SpHIP=620 

05 pATE=REQ-620 

OS DATE=}PROM=-620 

O5 FILLER 
RECORD NAME ORDER@ITEM 
RECORD ae) 621 ¢ 
LOCATION MODE VIA ITEM 
WITHIN ORDER“AREA 

os PRODeNGQ*621 

OS FILLER 

0S LOT-nN0-62) 

OS FILLER 

QS QTY-0Rp=-62} 

OS aQtyYy-SH;P-62) 

OS FILLER 
RECORO NAME QRD@REMARK 
RECORD 1D 622 ¢ 
LOCATION MODE OIRECT. 
WITHIN OROER@AREA 

O03 ORD-REmM-CD0-622, 

O05 REMARKeCO0=622 

OS REMARKeSEQ=-622 

05 REMARKe422 

OS FILLER 
RECORD NAME pROOUCT 
RECORD 10 631 e¢ 
LOCATION MODE 
WITHIN PRODUCT@AREA 

05 pROD@eNQ-63) 

OS FILLER 

QS PROD@-DESeINTH=431 

O05 PROD@DESmEXTHo$33} 

OS FILLER 


wet eet beh FEE OP WE ie WW 


SETe 
AREAS. 


COMP a3 
COMPe3 


AREA 


CALC USING PROD-N0-63)1 


AREAe 


PIC 
PIC 
Pic 
PICc 
PIC 
PIC 
PIC 


PIC 
Pic 
PIC 
PIC 
Pic 
PIC 
PIC 


PIC 
PIC 
PIC 
PIC 


PAGE REVISION PAGE 


X(8). 
X(18). 
X(Z7 de 
X(6)6 
X(6). 
Xb) 
X(133), 


XOY2N)6 
XXXe 
X(7), 
X(4), 
S97) 6 
S97 ).6 
X¥(34), 


Xe 

Xe 
X(75)-6 
XXXe 


DUPLICATES NOT ALLOwEDe 


PIr¢ 
PIC 
PIC 
Pic 
PIC 


XO12) 6 
XXe 

X¥(15), 
X( 30). 
X(S3)6 


SHS SESS HSKEHOTRES FE RSESCHS HO SHOFOHSSEEHHHSSSECHEE SSBC RHEE ESS 


_ SET DESCRIPTION STATEMENTS 
POSE SESE ET OTOHEHEOSEHOHEEESHOS EHEC EHO ROHEHOEOE LORE EHS 


O10100 SET DESCRIPTIONe 


010200 


010300 SET NAMe ORDOR 
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0104900 ORDER SORTED. ‘ a 
010500 MODE CHAIN LINKED PRIOR. 

010600 OWNER CUSTOMER NEXT POSITION 1 PRIOR POSITION 2¢ 
010700 MEMBER CUST@ORDER NEXT POSITION. 1 PRIOR POSITIUN 2 
010800 MANDATORY AUTOMATIC LINKED OWNER OWNER POSITION 3 
010900 ASCENDING KEY FO=NQ~-620 DUPLICATES NOT ALLOWEDe 
0:1000 

O11100 SET NAMe ITEM ‘ 

011200 ORDER NEXT. 

011300 MODE CHAIN LINKED PRIOR» 

011400 OWNER CUST*ORDER NEXT POSITION 6 PRIOR POSITION 7.0 
031500 MEMBER ORDERmwITEM NEXT POSITION 1 PRIOR POSITION 2 
0113600 MANDATORY AUTOMATIC LINKED OWNER OWNER POSITION ge 
031700 

011800 SET NAME SPEC@REMARK e 

011900 ORDER LASTe 

012000 MODE CHAIN LINKED PRIOR. 

012100 OWNER CUST@ORDER NEXT POSITION 4 PRIOR POSITION Se 
012200 MEMBER ORD=REMARK NEXT POSITION 3 PRIOR POSITION 2 
012300 OPTIONAL MANUAL. 

012400 

012500 SET NAMe PROD@ORD e 

012600 ORDER SORTEDs 

Ot2700 MODE CHAIN LINKED PRIOR. 

012800 OWNER PRODUCT NEXT POSITION 3 PRIOR POSITION 26 
012900 MEMBER ORDER@ITEM NEXT POSITION 4& PRIOR POSITION 5g 
0:3000 OPTIONAL AUTOMATIC LINKED OWNER OWNER POSITION 6 
013100 ASCENDING KEY LOT=NO=-621 DUPLICATES NOT ALLOwEDe 
013200 

013300 

013400 

0:3500 

013600 


033700 
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D.3. THE SUBSCHEMA DEFINITION (DMSSUBS) 


ocaliooe 
ooc200e 
000300¢ 
o0o4ooe 
ooosooe 
000600 
000700 
00Gg800 
000900 
001000 
001100 
001200 
001300 
001400 
b0:500 
001600 
003700 
00: 800 
001900¢ 
o0200c0¢ 
002100¢e 
ago0220ce 


SES _ga® SSCs MF eS HSeSseFatSeSFegeesseseesee SF eeePCaesesevesSesseatetese 


SUBSCHEMA [IDENTIFICATION STATEMENTS ° 


SPSS Kg eFSSSF eS eFCSSseH ete seSaeeeeee se oetseetesesestoateosrseatetes 


SUBSCHEmMA IDENTIFICATION DIVISIONS 


SUBSCHEmMA NAME IS DMSSUBS OF SCHEMA NAME OMSSCHMe 


AUTHOR. 


DATE. 


INSTALLATION, 


REMARKS, 


OMS/90 PROGRAMMERS, 
O4/10/736 
SPERRYSUNIVAC BLUE BELL. 


THIS IS THE DMS/99 SAMPLE SUBSCHEMA, 


POS SoS FSSCST SSSHHSHSSEHSESEFSE KH HLEHDEHHEHSHE HEF ESHSSHCSCESECHOBE SS EF ESE 


SUBSCHEMA DATA STATEMENTS 6 


FSSN SSCSCHSS eH aESSHSSESSHSHPEHTESSHHeeSFeseteegetesleOevevtatee 


002300 SUBSCHEMA DATA DIVISIONe 


002400 
002509 
002600 
002700 
002809 
002909 
003000 
003100 
003206 
003300 
003400 
003500 
003600 
003700 
003800 
003909 
004000 
004100 
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004400 


AREA SECTION, 


COPY 
CoPy 
CoPy 


CUSTOMER@AREA AREA, 
ORDER@AREA AREAs 
PRODUCT@AREA AREA. 


RECORD SECTION, 


SET 


004500 


COoPy CUSTOMER. RECORD. 
COPy CUST@ORDER RECORD. 
COPy ORDEReI TEM RECORDe 
COPy ORDmeREMARK RECORD. 
COPy PRODUCT RECORD. 
SECTIONe 

COPy ORDOR SET. 
CoPy ITEm SET. 
COPy SPEC@REMARK SET, 
COoPy PROD=ORD SET. 
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Appendix E. DMS/90 Clock Rule 


E.1. GENERAL 


Record occurrences in a DMS/90 data base must be linked together as specified in the data base schema. An 
occurrence of a record type has two portions, control and data. The control portion is under the exclusive control of 
DMS/90. It is not accessible to any application program. It contains links in the form of 1-word data base keys that 
point to other record occurrences. DMS/90 maintains the links in response to DML requests made by application 
programs and in accordance with the description of the data base contained in object subschemas. 


E.2. ASSIGNING DATA BASE KEY POSITION NUMBERS 


The location of each link within the contro! portion of a given record type must be specified in the schema by using 
@ the DBKEY POSITION clauses in the OWNER and MEMBER sentences of the set entries. 


The following rules must be observed when assigning data base key position numbers for a given record type: 
1. The numbers must be unique within record type. 
2. They must be assigned as consecutive integers beginning with 1 and ending with a number less than 100. 


3. All sets within which the record type is a member must be considered first. The sets within this group may be 
considered in any order. For a given set, data base key position numbers must be assigned in the order N, NP, 
NO, or NPO, depending upon which linkage option is required. 


4. Once positions have been assigned for all sets in item 3, then all sets within which the record type is an owner 
must be considered. The sets within this group may be considered in any order. For a given set, data base key 
position numbers must be assigned in the N or NP order, depending upon which linkage option is required. An 
owner data base key position is never assigned for the owner record type. 


5. Data base key positions associated with the CALC location mode are accounted for by the system and should 
not be numbered in the schema. 


It may be convenient to use the clock rule to assign data base key positions. The clock rule is a procedure that uses 
the network data structure diagram (refer to the data manipulation language manua!, UP-8036 (current version)), an 
example of which is shown in Figure E—1. This procedure is a systematic way of following the preceding rules. 
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Figure E—1, Clock Rule Example for Assigning Data Base Key Position Numbers 


PROD—ORD NPO OA 


ASC LOT—NO—621 DN 





(1, 2) (4, 5, 6) 


Consider the problem of assigning data base key position numbers for the CUST-ORDER record type shown in 
Figure E—1. Imagine the record representation superimposed on the face of a clock. Beginning at the 12 o'clock 
position and moving clockwise, the clock is circled twice, the first time to number al! data base key positions for sets 
in which the record participates as a member, and the second time to number all data base key positions for sets in 
which the record participates as an owner. The first data base key position encountered is assigned the number 1, 
others being consecutively numbered from 1, incrementing by 1 for each. 


Returning to Figure E—1, note that the CUST-ORDER record is a member of the ORDOR set, and NEXT, PRIOR, 
and OWNER (NPO) linkage is specified to which the numbers 1, 2, and 3 are assigned the first time around the 
clock. Continuing around the clock, the second time, for owner linkages the numbers 4 and 5 are assigned to the 
NEXT and PRIOR (NP) linkage required for the SPEC-REMARK set, and the numbers 6 and 7 are assigned to the 
NEXT and PRIOR linkage required for the {TEM set. No number is assigned for the OWNER linkage of the ITEM 
set because that data base key position is only defined in the ORDER-ITEM member record, i.e., the owner does not 
need to be linked to itself. 


Figure E—1 is a network data base diagram of the DMS/90 sample schema/subschema. Schema DDL statements and 
resultant calculations from the clock rule as applied to the sample can be found in the processor report examples in 
Appendix D.2. 
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